Initial revision
authorEric S. Raymond <esr@snark.thyrsus.com>
Sat, 3 Apr 1993 23:28:03 +0000 (23:28 +0000)
committerEric S. Raymond <esr@snark.thyrsus.com>
Sat, 3 Apr 1993 23:28:03 +0000 (23:28 +0000)
lisp/faces.el [new file with mode: 0644]
lisp/help-macro.el [new file with mode: 0644]

diff --git a/lisp/faces.el b/lisp/faces.el
new file mode 100644 (file)
index 0000000..0766894
--- /dev/null
@@ -0,0 +1,740 @@
+;;; faces.el --- Lisp interface to the c "face" structure
+
+;; Copyright (C) 1992, 1993 Free Software Foundation, Inc.
+
+;; This file is part of GNU Emacs.
+
+;; GNU Emacs is free software; you can redistribute it and/or modify
+;; it under the terms of the GNU General Public License as published by
+;; the Free Software Foundation; either version 2, or (at your option)
+;; any later version.
+
+;; GNU Emacs is distributed in the hope that it will be useful,
+;; but WITHOUT ANY WARRANTY; without even the implied warranty of
+;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+;; GNU General Public License for more details.
+
+;; You should have received a copy of the GNU General Public License
+;; along with GNU Emacs; see the file COPYING.  If not, write to
+;; the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
+
+;;; Commentary:
+
+;; Mostly derived from Lucid.
+
+;;; Code:
+
+(defsubst internal-facep (x)
+  (and (vectorp x) (= (length x) 8) (eq (aref x 0) 'face)))
+
+(defmacro internal-check-face (face)
+  (` (while (not (internal-facep (, face)))
+       (setq (, face) (signal 'wrong-type-argument (list 'internal-facep (, face)))))))
+
+
+(defvar global-face-data nil "do not use this")
+
+(defun face-list ()
+  "Returns a list of all defined face names."
+  (mapcar 'car global-face-data))
+
+(defun internal-find-face (name &optional frame)
+  "Retrieve the face named NAME.  Return nil if there is no such face.
+If the optional argument FRAME is given, this gets the face NAME for
+that frame; otherwise, it uses the selected frame.
+If FRAME is the symbol t, then the global, non-frame face is returned.
+If NAME is already a face, it is simply returned."
+  (if (and (eq frame t) (not (symbolp name)))
+      (setq name (face-name name)))
+  (if (symbolp name)
+      (cdr (assq name
+                (if (eq frame t)
+                    global-face-data
+                  (frame-face-alist (or frame (selected-frame))))))
+    (internal-check-face name)
+    name))
+
+(defun internal-get-face (name &optional frame)
+  "Retrieve the face named NAME; error if there is none.
+If the optional argument FRAME is given, this gets the face NAME for
+that frame; otherwise, it uses the selected frame.
+If FRAME is the symbol t, then the global, non-frame face is returned.
+If NAME is already a face, it is simply returned."
+  (or (internal-find-face name frame)
+      (internal-check-face name)))
+
+(defsubst face-name (face)
+  "Return the name of face FACE."
+  (aref (internal-get-face face) 1))
+
+(defsubst face-id (face)
+  "Return the internal ID number of face FACE."
+  (aref (internal-get-face face) 2))
+
+(defsubst face-font (face &optional frame)
+  "Return the font name of face FACE, or nil if it is unspecified.
+If the optional argument FRAME is given, report on face FACE in that frame.
+Otherwise report on the defaults for face FACE (for new frames)."
+  (aref (internal-get-face face frame) 3))
+
+(defsubst face-foreground (face &optional frame)
+  "Return the foreground color name of face FACE, or nil if unspecified.
+If the optional argument FRAME is given, report on face FACE in that frame.
+Otherwise report on the defaults for face FACE (for new frames)."
+  (aref (internal-get-face face frame) 4))
+
+(defsubst face-background (face &optional frame)
+  "Return the background color name of face FACE, or nil if unspecified.
+If the optional argument FRAME is given, report on face FACE in that frame.
+Otherwise report on the defaults for face FACE (for new frames)."
+  (aref (internal-get-face face frame) 5))
+
+(defsubst face-background-pixmap (face &optional frame)
+ "Return the background pixmap name of face FACE, or nil if unspecified.
+If the optional argument FRAME is given, report on face FACE in that frame.
+Otherwise report on the defaults for face FACE (for new frames)."
+ (aref (internal-get-face face frame) 6))
+
+(defsubst face-underline-p (face &optional frame)
+ "Return t if face FACE is underlined.
+If the optional argument FRAME is given, report on face FACE in that frame.
+Otherwise report on the defaults for face FACE (for new frames)."
+ (aref (internal-get-face face frame) 7))
+
+
+(defun internat-set-face-1 (face name value index frame)
+  (let ((inhibit-quit t))
+    (if (null frame)
+       (let ((frames (frame-list)))
+         (while frames
+           (internat-set-face-1 (face-name face) name value index (car frames))
+           (setq frames (cdr frames)))
+         (aset (internal-get-face (if (symbolp face) face (face-name face)) t)
+               index value)
+         value)
+      (or (eq frame t)
+         (set-face-attribute-internal (face-id face) name value frame))
+      (aset (internal-get-face face frame) index value))))
+
+
+(defun read-face-name (prompt)
+  (let (face)
+    (while (= (length face) 0)
+      (setq face (completing-read prompt
+                                 (mapcar '(lambda (x) (list (symbol-name x)))
+                                         (list-faces))
+                                 nil t)))
+    (intern face)))
+
+(defun internal-face-interactive (what &optional bool)
+  (let* ((fn (intern (concat "face-" what)))
+        (prompt (concat "Set " what " of face"))
+        (face (read-face-name (concat prompt ": ")))
+        (default (if (fboundp fn)
+                     (or (funcall fn face (selected-frame))
+                         (funcall fn 'default (selected-frame)))))
+        (value (if bool
+                   (y-or-n-p (concat "Should face " (symbol-name face)
+                                     " be " bool "? "))
+                 (read-string (concat prompt " " (symbol-name face) " to: ")
+                              default))))
+    (list face (if (equal value "") nil value))))
+
+
+(defsubst set-face-font (face font &optional frame)
+  "Change the font of face FACE to FONT (a string).
+If the optional FRAME argument is provided, change only
+in that frame; otherwise change each frame."
+  (interactive (internal-face-interactive "font"))
+  (internat-set-face-1 face 'font font 3 frame))
+
+(defsubst set-face-foreground (face color &optional frame)
+  "Change the foreground color of face FACE to COLOR (a string).
+If the optional FRAME argument is provided, change only
+in that frame; otherwise change each frame."
+  (interactive (internal-face-interactive "foreground"))
+  (internat-set-face-1 face 'foreground color 4 frame))
+
+(defsubst set-face-background (face color &optional frame)
+  "Change the background color of face FACE to COLOR (a string).
+If the optional FRAME argument is provided, change only
+in that frame; otherwise change each frame."
+  (interactive (internal-face-interactive "background"))
+  (internat-set-face-1 face 'background color 5 frame))
+
+(defsubst set-face-background-pixmap (face name &optional frame)
+  "Change the background pixmap of face FACE to PIXMAP.
+PIXMAP should be a string, the name of a file of pixmap data.
+The directories listed in the `x-bitmap-file-path' variable are searched.
+
+Alternatively, PIXMAP may be a list of the form (WIDTH HEIGHT DATA)
+where WIDTH and HEIGHT are the size in pixels,
+and DATA is a string, containing the raw bits of the bitmap.  
+
+If the optional FRAME argument is provided, change only
+in that frame; otherwise change each frame."
+  (interactive (internal-face-interactive "background-pixmap"))
+  (internat-set-face-1 face 'background-pixmap name 6 frame))
+
+(defsubst set-face-underline-p (face underline-p &optional frame)
+  "Specify whether face FACE is underlined.  (Yes if UNDERLINE-P is non-nil.)
+If the optional FRAME argument is provided, change only
+in that frame; otherwise change each frame."
+  (interactive (internal-face-interactive "underline-p" "underlined"))
+  (internat-set-face-1 face 'underline underline-p 7 frame))
+
+
+(defun make-face (name)
+  "Define a new FACE on all frames.  
+You can modify the font, color, etc of this face with the set-face- functions.
+If the face already exists, it is unmodified."
+  (or (internal-find-face name)
+      (let ((face (make-vector 8 nil)))
+       (aset face 0 'face)
+       (aset face 1 name)
+       (let* ((frames (frame-list))
+              (inhibit-quit t)
+              (id (internal-next-face-id)))
+         (make-face-internal id)
+         (aset face 2 id)
+         (while frames
+           (set-frame-face-alist (car frames)
+                                 (cons (cons name (copy-sequence face))
+                                       (frame-face-alist (car frames))))
+           (setq frames (cdr frames)))
+         (setq global-face-data (cons (cons name face) global-face-data)))
+       ;; when making a face after frames already exist
+       (if (eq window-system 'x)
+           (make-face-x-resource-internal face))
+       face)))
+
+;; Fill in a face by default based on X resources, for all existing frames.
+;; This has to be done when a new face is made.
+(defun make-face-x-resource-internal (face &optional frame set-anyway)
+  (cond ((null frame)
+        (let ((frames (frame-list)))
+          (while frames
+            (make-face-x-resource-internal (face-name face)
+                                           (car frames) set-anyway)
+            (setq frames (cdr frames)))))
+       (t
+        (setq face (internal-get-face (face-name face) frame))
+        ;;
+        ;; These are things like "attributeForeground" instead of simply
+        ;; "foreground" because people tend to do things like "*foreground",
+        ;; which would cause all faces to be fully qualified, making faces
+        ;; inherit attributes in a non-useful way.  So we've made them slightly
+        ;; less obvious to specify in order to make them work correctly in
+        ;; more random environments.
+        ;;
+        ;; I think these should be called "face.faceForeground" instead of
+        ;; "face.attributeForeground", but they're the way they are for
+        ;; hysterical reasons.
+        ;; 
+        (let* ((name (symbol-name (face-name face)))
+               (fn  (or (x-get-resource (concat name ".attributeFont")
+                                        "Face.AttributeFont")
+                        (and set-anyway (face-font face))))
+               (fg  (or (x-get-resource (concat name ".attributeForeground")
+                                        "Face.AttributeForeground")
+                        (and set-anyway (face-foreground face))))
+               (bg  (or (x-get-resource (concat name ".attributeBackground")
+                                        "Face.AttributeBackground")
+                        (and set-anyway (face-background face))))
+;;             (bgp (or (x-get-resource (concat name ".attributeBackgroundPixmap")
+;;                                      "Face.AttributeBackgroundPixmap")
+;;                      (and set-anyway (face-background-pixmap face))))
+               (ulp (or (x-get-resource (concat name ".attributeUnderline")
+                                        "Face.AttributeUnderline")
+                        (and set-anyway (face-underline-p face))))
+               )
+          (if fn
+              (condition-case ()
+                  (set-face-font face fn frame)
+                (error (message "font `%s' not found for face `%s'" fn name))))
+          (if fg
+              (condition-case ()
+                  (set-face-foreground face fg frame)
+                (error (message "color `%s' not allocated for face `%s'" fg name))))
+          (if bg
+              (condition-case ()
+                  (set-face-background face bg frame)
+                (error (message "color `%s' not allocated for face `%s'" bg name))))
+;;        (if bgp
+;;            (condition-case ()
+;;                (set-face-background-pixmap face bgp frame)
+;;              (error (message "pixmap `%s' not found for face `%s'" bgp name))))
+          (if (or ulp set-anyway)
+              (set-face-underline-p face ulp frame))
+          )))
+  face)
+
+(defun copy-face (old-face new-name &optional frame)
+  "Define a face just like OLD-FACE, with name NEW-NAME.
+If NEW-NAME already exists as a face, it is modified to be like OLD-FACE.
+If the optional argument FRAME is given, this applies only to that frame.
+Otherwise it applies to each frame separately."
+  (setq old-face (internal-get-face old-face frame))
+  (let* ((inhibit-quit t)
+        (new-face (or (internal-find-face new-name frame)
+                      (make-face new-name))))
+    (if (null frame)
+       (let ((frames (frame-list)))
+         (while frames
+           (copy-face old-face new-name (car frames))
+           (setq frames (cdr frames)))
+         (copy-face old-face new-name t))
+      (set-face-font new-face (face-font old-face frame) frame)
+      (set-face-foreground new-face (face-foreground old-face frame) frame)
+      (set-face-background new-face (face-background old-face frame) frame)
+      (set-face-background-pixmap
+       new-face (face-background-pixmap old-face frame) frame)
+      (set-face-underline-p new-face (face-underline-p old-face frame)
+                           frame))
+    new-face))
+
+(defun face-equal (face1 face2 &optional frame)
+  "True if the faces FACE1 and FACE2 display in the the same way."
+  (setq face1 (internal-get-face face1 frame)
+       face2 (internal-get-face face2 frame))
+  (and (equal (face-foreground face1 frame) (face-foreground face2 frame))
+       (equal (face-background face1 frame) (face-background face2 frame))
+       (equal (face-font face1 frame) (face-font face2 frame))
+       (equal (face-background-pixmap face1 frame)
+             (face-background-pixmap face2 frame))))
+
+(defun face-differs-from-default-p (face &optional frame)
+  "True if face FACE displays differently from the default face, on FRAME.
+A face is considered to be ``the same'' as the default face if it is 
+actually specified in the same way (equivalent fonts, etc) or if it is 
+fully unspecified, and thus inherits the attributes of any face it 
+is displayed on top of."
+  (let ((default (internal-get-face 'default frame)))
+    (setq face (internal-get-face face frame))
+    (not (and (or (equal (face-foreground default frame)
+                        (face-foreground face frame))
+                 (null (face-foreground face frame)))
+             (or (equal (face-background default frame)
+                        (face-background face frame))
+                 (null (face-background face frame)))
+             (or (equal (face-font default frame) (face-font face frame))
+                 (null (face-font face frame)))
+             (or (equal (face-background-pixmap default frame)
+                        (face-background-pixmap face frame))
+                 (null (face-background-pixmap face frame)))
+             (equal (face-underline-p default frame)
+                    (face-underline-p face frame))
+             ))))
+
+
+(defun invert-face (face &optional frame)
+  "Swap the foreground and background colors of face FACE.
+If the face doesn't specify both foreground and background, then
+its foreground and background are set to the background and
+foreground of the default face."
+  (interactive (list (read-face-name "Invert face: ")))
+  (setq face (internal-get-face face frame))
+  (let ((fg (face-foreground face frame))
+       (bg (face-background face frame)))
+    (if (or fg bg)
+       (progn
+         (set-face-foreground face bg frame)
+         (set-face-background face fg frame))
+      (set-face-foreground face (face-background 'default frame) frame)
+      (set-face-background face (face-foreground 'default frame) frame)))
+  face)
+
+
+(defun internal-try-face-font (face font &optional frame)
+  "Like set-face-font, but returns nil on failure instead of an error."
+  (condition-case ()
+      (set-face-font face font frame)
+    (error nil)))
+
+
+(defun set-default-font (font)
+  "Sets the font used for normal text and the modeline to FONT in all frames.
+For finer-grained control, use set-face-font."
+  (interactive (list (read-string "Set default font: "
+                                 (face-font 'default (selected-frame)))))
+  (set-face-font 'default font)
+  (set-face-font 'modeline font))
+\f
+;; Manipulating font names.
+
+(defconst x-font-regexp nil)
+(defconst x-font-regexp-head nil)
+(defconst x-font-regexp-weight nil)
+(defconst x-font-regexp-slant nil)
+
+;;; Regexps matching font names in "Host Portable Character Representation."
+;;;
+(let ((-               "[-?]")
+      (foundry         "[^-]+")
+      (family          "[^-]+")
+      (weight          "\\(bold\\|demibold\\|medium\\)")               ; 1
+;     (weight\?                "\\(\\*\\|bold\\|demibold\\|medium\\|\\)")      ; 1
+      (weight\?                "\\([^-]*\\)")                                  ; 1
+      (slant           "\\([ior]\\)")                                  ; 2
+;     (slant\?         "\\([ior?*]?\\)")                               ; 2
+      (slant\?         "\\([^-]?\\)")                                  ; 2
+;     (swidth          "\\(\\*\\|normal\\|semicondensed\\|\\)")        ; 3
+      (swidth          "\\([^-]*\\)")                                  ; 3
+;     (adstyle         "\\(\\*\\|sans\\|\\)")                          ; 4
+      (adstyle         "[^-]*")                                        ; 4
+      (pixelsize       "[0-9]+")
+      (pointsize       "[0-9][0-9]+")
+      (resx            "[0-9][0-9]+")
+      (resy            "[0-9][0-9]+")
+      (spacing         "[cmp?*]")
+      (avgwidth                "[0-9]+")
+      (registry                "[^-]+")
+      (encoding                "[^-]+")
+      )
+  (setq x-font-regexp
+       (concat "\\`\\*?[-?*]"
+               foundry - family - weight\? - slant\? - swidth - adstyle -
+               pixelsize - pointsize - resx - resy - spacing - registry -
+               encoding "[-?*]\\*?\\'"
+               ))
+  (setq x-font-regexp-head
+       (concat "\\`[-?*]" foundry - family - weight\? - slant\?
+               "\\([-*?]\\|\\'\\)"))
+  (setq x-font-regexp-slant (concat - slant -))
+  (setq x-font-regexp-weight (concat - weight -))
+  nil)     
+
+(defun x-frob-font-weight (font which)
+  (if (or (string-match x-font-regexp font)
+         (string-match x-font-regexp-head font)
+         (string-match x-font-regexp-weight font))
+      (concat (substring font 0 (match-beginning 1)) which
+             (substring font (match-end 1)))
+    nil))
+
+(defun x-frob-font-slant (font which)
+  (cond ((or (string-match x-font-regexp font)
+            (string-match x-font-regexp-head font))
+        (concat (substring font 0 (match-beginning 2)) which
+                (substring font (match-end 2))))
+       ((string-match x-font-regexp-slant font)
+        (concat (substring font 0 (match-beginning 1)) which
+                (substring font (match-end 1))))
+       (t nil)))
+
+
+(defun x-make-font-bold (font)
+  "Given an X font specification, this attempts to make a `bold' version
+of it.  If it fails, it returns nil."
+  (x-frob-font-weight font "bold"))
+
+(defun x-make-font-demibold (font)
+  "Given an X font specification, this attempts to make a `demibold' version
+of it.  If it fails, it returns nil."
+  (x-frob-font-weight font "demibold"))
+
+(defun x-make-font-unbold (font)
+  "Given an X font specification, this attempts to make a non-bold version
+of it.  If it fails, it returns nil."
+  (x-frob-font-weight font "medium"))
+
+(defun x-make-font-italic (font)
+  "Given an X font specification, this attempts to make an `italic' version
+of it.  If it fails, it returns nil."
+  (x-frob-font-slant font "i"))
+
+(defun x-make-font-oblique (font) ; you say tomayto...
+  "Given an X font specification, this attempts to make an `italic' version
+of it.  If it fails, it returns nil."
+  (x-frob-font-slant font "o"))
+
+(defun x-make-font-unitalic (font)
+  "Given an X font specification, this attempts to make a non-italic version
+of it.  If it fails, it returns nil."
+  (x-frob-font-slant font "r"))
+
+\f
+;;; non-X-specific interface
+
+(defun make-face-bold (face &optional frame)
+  "Make the font of the given face be bold, if possible.  
+Returns nil on failure."
+  (interactive (list (read-face-name "Make which face bold: ")))
+  (let ((ofont (face-font face frame)))
+    (if (null frame)
+       (let ((frames (frame-list)))
+         (while frames
+           (make-face-bold face (car frames))
+           (setq frames (cdr frames))))
+      (setq face (internal-get-face face frame))
+      (let ((font (or (face-font face frame)
+                     (face-font face t)
+                     (face-font 'default frame)))
+           f2)
+       (or (and (setq f2 (x-make-font-bold font))
+                (try-face-font face f2))
+           (and (setq f2 (x-make-font-demibold font))
+                (try-face-font face f2)))))
+    (not (equal ofont (face-font face)))))
+
+(defun make-face-italic (face &optional frame)
+  "Make the font of the given face be italic, if possible.  
+Returns nil on failure."
+  (interactive (list (read-face-name "Make which face italic: ")))
+  (let ((ofont (face-font face frame)))
+    (if (null frame)
+       (let ((frames (frame-list)))
+         (while frames
+           (make-face-italic face (car frames))
+           (setq frames (cdr frames))))
+      (setq face (internal-get-face face frame))
+      (let ((font (or (face-font face frame)
+                     (face-font face t)
+                     (face-font 'default frame)))
+           f2)
+       (or (and (setq f2 (x-make-font-italic font))
+                (try-face-font face f2))
+           (and (setq f2 (x-make-font-oblique font))
+                (try-face-font face f2)))))
+    (not (equal ofont (face-font face)))))
+
+(defun make-face-bold-italic (face &optional frame)
+  "Make the font of the given face be bold and italic, if possible.  
+Returns nil on failure."
+  (interactive (list (read-face-name "Make which face bold-italic: ")))
+  (let ((ofont (face-font face frame)))
+    (if (null frame)
+       (let ((frames (frame-list)))
+         (while frames
+           (make-face-bold-italic face (car frames))
+           (setq frames (cdr frames))))
+      (setq face (internal-get-face face frame))
+      (let ((font (or (face-font face frame)
+                     (face-font face t)
+                     (face-font 'default frame)))
+           f2 f3)
+       (or (and (setq f2 (x-make-font-italic font))
+                (not (equal font f2))
+                (setq f3 (x-make-font-bold f2))
+                (not (equal f2 f3))
+                (try-face-font face f3))
+           (and (setq f2 (x-make-font-oblique font))
+                (not (equal font f2))
+                (setq f3 (x-make-font-bold f2))
+                (not (equal f2 f3))
+                (try-face-font face f3))
+           (and (setq f2 (x-make-font-italic font))
+                (not (equal font f2))
+                (setq f3 (x-make-font-demibold f2))
+                (not (equal f2 f3))
+                (try-face-font face f3))
+           (and (setq f2 (x-make-font-oblique font))
+                (not (equal font f2))
+                (setq f3 (x-make-font-demibold f2))
+                (not (equal f2 f3))
+                (try-face-font face f3)))))
+    (not (equal ofont (face-font face frame)))))
+
+(defun make-face-unbold (face &optional frame)
+  "Make the font of the given face be non-bold, if possible.  
+Returns nil on failure."
+  (interactive (list (read-face-name "Make which face non-bold: ")))
+  (let ((ofont (face-font face frame)))
+    (if (null frame)
+       (let ((frames (frame-list)))
+         (while frames
+           (make-face-unbold face (car frames))
+           (setq frames (cdr frames))))
+      (setq face (internal-get-face face frame))
+      (let ((font (x-make-font-unbold
+                  (or (face-font face frame)
+                      (face-font face t)
+                      (face-font 'default frame)))))
+       (if font (try-face-font face font))))
+    (not (equal ofont (face-font face frame)))))
+
+(defun make-face-unitalic (face &optional frame)
+  "Make the font of the given face be non-italic, if possible.  
+Returns nil on failure."
+  (interactive (list (read-face-name "Make which face non-italic: ")))
+  (let ((ofont (face-font face frame)))
+    (if (null frame)
+       (let ((frames (frame-list)))
+         (while frames
+           (make-face-unitalic face (car frames))
+           (setq frames (cdr frames))))
+      (setq face (internal-get-face face frame))
+      (let ((font (x-make-font-unitalic
+                  (or (face-font face frame)
+                      (face-font face t)
+                      (face-font 'default frame)))))
+       (if font (try-face-font face font))))
+    (not (equal ofont (face-font face frame)))))
+
+
+
+\f
+;;; Make the builtin faces; the C code knows these as faces 0, 1, and 2,
+;;; respectively, so they must be the first three faces made.
+
+(if (internal-find-face 'default)
+    nil
+  (make-face 'default)
+  (make-face 'modeline)
+  (make-face 'highlight)
+  ;;
+  ;; These aren't really special in any way, but they're nice to have around.
+  ;; The X-specific code is clever at them.
+  ;;
+  (make-face 'bold)
+  (make-face 'italic)
+  (make-face 'bold-italic)
+  (make-face 'primary-selection)
+  (make-face 'secondary-selection))
+\f
+;;; This really belongs in setting a frame's own font.
+;;;     ;;
+;;;     ;; No font specified in the resource database; try to cope.
+;;;     ;;
+;;;     (internal-try-face-font default "-*-courier-medium-r-*-*-*-120-*-*-*-*-iso8859-*"
+;;;                         frame)
+;;;     (internal-try-face-font default "-*-courier-*-r-*-*-*-120-*-*-*-*-iso8859-*"
+;;;                         frame)
+;;;     (internal-try-face-font default "-*-*-medium-r-*-*-*-120-*-*-m-*-iso8859-*" frame)
+;;;     (internal-try-face-font default "-*-*-medium-r-*-*-*-120-*-*-c-*-iso8859-*" frame)
+;;;     (internal-try-face-font default "-*-*-*-r-*-*-*-120-*-*-m-*-iso8859-*" frame)
+;;;     (internal-try-face-font default "-*-*-*-r-*-*-*-120-*-*-c-*-iso8859-*" frame)
+;;;     (internal-try-face-font default "-*-*-*-r-*-*-*-120-*-*-*-*-iso8859-*" frame)
+
+
+;;; This is called from make-screen-initial-faces to make sure that the
+;;; "default" and "modeline" faces for this screen have enough attributes
+;;; specified for emacs to be able to display anything on it.  This had
+;;; better not signal an error.
+;;;
+(defun x-initialize-frame-faces (frame)
+  (or (face-differs-from-default-p 'bold frame)
+      (make-face-bold 'bold frame)
+      ;; if default font is bold, then make the `bold' face be unbold.
+      (make-face-unbold 'bold frame)
+      ;; otherwise the luser specified one of the bogus font names
+      (internal-x-complain-about-font 'bold)
+      )
+
+  (or (face-differs-from-default-p 'italic frame)
+      (make-face-italic 'italic frame)
+      (progn
+       (make-face-bold 'italic frame)
+       (internal-x-complain-about-font 'italic))
+      )
+
+  (or (face-differs-from-default-p 'bold-italic frame)
+      (make-face-bold-italic 'bold-italic frame)
+      ;; if we couldn't get a bold-italic version, try just bold.
+      (make-face-bold 'bold-italic frame)
+      ;; if we couldn't get bold or bold-italic, then that's probably because
+      ;; the default font is bold, so make the `bold-italic' face be unbold.
+      (and (make-face-unbold 'bold-italic frame)
+          (make-face-italic 'bold-italic frame))
+      ;; if that didn't work, try italic (can this ever happen? what the hell.)
+      (progn
+       (make-face-italic 'bold-italic frame)
+       ;; then bitch and moan.
+       (internal-x-complain-about-font 'bold-italic))
+      )
+
+  (or (face-differs-from-default-p 'highlight frame)
+      (condition-case ()
+         (if (x-display-color-p)
+              (condition-case ()
+                 (set-face-background 'highlight "darkseagreen2" frame)
+                (error (set-face-background 'highlight "green" frame)))
+           (set-face-background-pixmap 'highlight "gray1" frame)
+           )
+       (error (invert-face 'highlight frame))))
+
+  (or (face-differs-from-default-p 'primary-selection frame)
+      (condition-case ()
+         (if (x-display-color-p)
+             (set-face-background 'primary-selection "gray" frame)
+           (set-face-background-pixmap 'primary-selection "gray3" frame)
+           )
+       (error (invert-face 'primary-selection frame))))
+
+  (or (face-differs-from-default-p 'secondary-selection frame)
+      (condition-case ()
+         (if (x-display-color-p)
+              (condition-case ()
+                 ;; some older X servers don't have this one.
+                 (set-face-background 'secondary-selection "paleturquoise"
+                                      frame)
+               (error
+                (set-face-background 'secondary-selection "green" frame)))
+           (set-face-background-pixmap 'secondary-selection "gray1" frame)
+           )
+       (error (invert-face 'secondary-selection frame))))
+
+  (or (face-differs-from-default-p 'isearch frame)
+      (if (x-display-color-p)
+         (condition-case ()
+             (set-face-background 'isearch "paleturquoise" frame)
+           (error
+            (condition-case ()
+                (set-face-background 'isearch "green" frame)
+              (error nil))))
+       nil)
+      (make-face-bold 'isearch frame)
+      ;; if default font is bold, then make the `isearch' face be unbold.
+      (make-face-unbold 'isearch frame))
+  ))
+
+(defun internal-x-complain-about-font (face)
+  (if (symbolp face) (setq face (symbol-name face)))
+  (message "%s: couldn't deduce %s %s version of %S\n"
+          invocation-name
+          (if (string-match "\\`[aeiouAEIOU]" face) "an" "a")
+          face
+          (face-font 'default))
+  (sit-for 1))
+\f
+;; Like x-create-frame but also set up the faces.
+
+(defun x-create-frame-with-faces (&optional parameters)
+  (let* ((frame (x-create-frame parameters))
+        (faces (copy-alist global-face-data))
+        (rest faces)
+        default modeline)
+    (set-frame-face-alist frame faces)
+
+    ;; Copy the vectors that represent the faces.
+    ;; Also fill them in from X resources.
+    (while rest
+      (setcdr (car rest) (copy-sequence (cdr (car rest))))
+      (make-face-x-resource-intenal (cdr (car rest)) frame t)
+      (setq rest (cdr rest)))
+
+    (setq default (internal-get-face 'default frame)
+         modeline (internal-get-face 'modeline frame))
+       
+    (x-initialize-frame-faces frame)
+
+    ;; Make sure the modeline face is fully qualified.
+    (if (and (not (face-font modeline frame)) (face-font default frame))
+       (set-face-font modeline (face-font default frame) frame))
+    (if (and (not (face-background modeline frame))
+            (face-background default frame))
+       (set-face-background modeline (face-background default frame) frame))
+    (if (and (not (face-foreground modeline frame))
+            (face-foreground default frame))
+       (set-face-foreground modeline (face-foreground default frame) frame))
+    frame))
+
+(setq frame-creation-function 'x-create-frame-with-faces)
+
+;; Set up the faces of all existing frames.
+(let ((frames (frame-list)))
+  (while frames
+    (x-initialize-frame-faces (car frames))
+    (setq frames (cdr frames))))
+
+;;; faces.el ends here
diff --git a/lisp/help-macro.el b/lisp/help-macro.el
new file mode 100644 (file)
index 0000000..fa8bf07
--- /dev/null
@@ -0,0 +1,108 @@
+;;; help-screen.el --- Makes command line help such as help-for-help
+
+;; Copyright (C) 1993 Free Software Foundation, Inc.
+
+;; Author: Lynn Slater <lrs@indetech.com>
+;; Created: : Mon Oct  1 11:42:39 1990
+;; Adapted-By: ESR
+;; Last Modified By: Lynn Slater x2048
+;; Last Modified On: Mon Sep 23 14:40:19 1991
+
+;; This file is part of GNU Emacs.
+
+;; GNU Emacs is free software; you can redistribute it and/or modify
+;; it under the terms of the GNU General Public License as published by
+;; the Free Software Foundation; either version 2, or (at your option)
+;; any later version.
+
+;; GNU Emacs is distributed in the hope that it will be useful,
+;; but WITHOUT ANY WARRANTY; without even the implied warranty of
+;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+;; GNU General Public License for more details.
+
+;; You should have received a copy of the GNU General Public License
+;; along with GNU Emacs; see the file COPYING.  If not, write to
+;; the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
+
+;;; Commentary:
+;;
+;;     This file supplies the macro make-help-screen which constructs
+;; single character dispatching with browsable help such as that provided
+;; by help-for-help. This can be used to make many modes easier to use; for
+;; example, the Gnu Emacs Empire Tool uses this for every "nested" mode map
+;; called from the main mode map.
+
+;;-> ***********************  Example of use *********************************
+
+;;->(make-help-screen help-for-empire-redistribute-map
+;;->             "c:civ m:mil p:population f:food ?"
+;;->             "You have discovered the GEET redistribution commands
+;;->   From here, you can use the following options:
+;;->
+;;->c  Redistribute civs from overfull sectors into connected underfull ones
+;;->     The functions typically named by empire-ideal-civ-fcn control
+;;->          based in part on empire-sector-civ-threshold  
+;;->m  Redistribute military using levels given by empire-ideal-mil-fcn
+;;->p  Redistribute excess population to highways for max pop growth
+;;->     Excess is any sector so full babies will not be born.
+;;->f  Even out food on highways to highway min and leave levels
+;;->     This is good to pump max food to all warehouses/dist pts
+;;->
+;;->
+;;->Use \\[help-for-empire-redistribute-map] for help on redistribution.
+;;->Use \\[help-for-empire-extract-map] for help on data extraction.
+;;->Please use \\[describe-key] to find out more about any of the other keys."
+;;->             empire-shell-redistribute-map)
+
+;;->  (define-key c-mp "\C-h" 'help-for-empire-redistribute-map)
+;;->  (define-key c-mp help-character 'help-for-empire-redistribute-map)
+
+;;; Change Log:
+;;
+;; 22-Jan-1991         Lynn Slater x2048       
+;;    Last Modified: Mon Oct  1 11:43:52 1990 #3 (Lynn Slater)
+;;    documented better
+
+;;; Code:
+
+(provide 'help-screen)
+(require 'backquote)
+
+(defmacro make-help-screen (fname help-line help-text helped-map)
+  "Constructs function FNAME that when invoked shows HELP-LINE and if a help
+character is requested, shows HELP-TEXT. The user is prompted for a character
+from the HELPED-MAP and the corresponding interactive function is executed."
+  (` (defun (, fname) ()
+          (, help-text)
+          (interactive)
+          (let ((line-prompt
+                 (substitute-command-keys (, help-line))))
+            (message line-prompt)
+            (let ((char (read-char)))
+              (if (or (= char ??) (= char help-char))
+                  (save-window-excursion
+                    (switch-to-buffer-other-window "*Help*")
+                    (erase-buffer)
+                    (insert (documentation (quote (, fname))))
+                    (goto-char (point-min))
+                    (while (memq char (cons help-char '(?? ?\C-v ?\ ?\177 ?\M-v)))
+                      (if (memq char '(?\C-v ?\ ))
+                          (scroll-up))
+                      (if (memq char '(?\177 ?\M-v))
+                          (scroll-down))
+                      (message "%s%s: "
+                               line-prompt
+                               (if (pos-visible-in-window-p (point-max))
+                                   "" " or Space to scroll"))
+                      (let ((cursor-in-echo-area t))
+                        (setq char (read-char))))))
+              (let ((defn (cdr (assq (downcase char) (, helped-map)))))
+                (if defn
+                    (if (keymapp defn)
+                        (error "sorry, this command cannot be run from the help screen. Start over.")
+                      (call-interactively defn))
+                  (ding))))))
+     ))
+
+;;; help-screen.el
+